W08-1. Service 와 Gateway API - 강의 노트
8주차 강의 노트: Service 와 Gateway API (외부 노출)
- Pod 앞에 Service 가 왜 필요한지, 어떻게 Pod 를 찾는지(selector) 설명할 수 있다.
- Service 타입 ClusterIP / NodePort / LoadBalancer 의 차이를 안다.
- 클러스터 안에서 서비스 이름(DNS) 으로 통신하는 법을 안다.
- Ingress-NGINX 지원 종료(2026년 3월) 와 그 후속 표준 Gateway API 를 이해하고, 도메인 주소로 앱을 공개할 수 있다.
진행: 이론 15분 (이 노트) → 실습 45분 (실습 가이드)
- Deployment 가 Pod 3개를 유지, 롤링 업데이트로 v1 → v2
- Pod 는 다시 만들어질 때마다 이름과 IP 가 바뀐다
port-forward는 Pod 하나에만 연결하는 테스트용 통로
1. 왜 Service 인가
Pod 의 IP 로 직접 접속하면 이런 문제가 생깁니다.
| 문제 | 설명 |
|---|---|
| IP 가 바뀐다 | Pod 가 죽고 새로 생기면, 롤링 업데이트를 하면 IP 가 바뀝니다 |
| 여러 개다 | Pod 가 3개면 어느 IP 로 보내야 하나? |
| 늘었다 줄었다 한다 | 스케일링할 때마다 목록이 바뀝니다 |
Service 는 Pod 묶음 앞에 세우는 고정된 대표 주소 + 로드밸런서입니다.
flowchart LR
C["다른 Pod
(예: 웹 → API)"] -- "http://guestbook" --> S["Service: guestbook
ClusterIP 10.96.134.220 (고정)
selector: app=guestbook"]
S --> P1["Pod 10.244.0.32
app=guestbook"]
S --> P2["Pod 10.244.0.33
app=guestbook"]
S --> P3["Pod 10.244.0.34
app=guestbook"]- Service 는
selector의 라벨이 붙은 Pod 를 자동으로 찾아 목록(EndpointSlice)을 유지합니다. - Pod 가 바뀌어도 Service 의 이름과 IP 는 그대로입니다.
- 들어온 요청은 Pod 들에 나눠서 보냅니다(로드밸런싱). 실제 전달 규칙은 각 노드의 kube-proxy 가 만듭니다.
Deployment(ReplicaSet)도, Service 도 라벨로 Pod 를 찾습니다. 그래서 7주차에 라벨을 바꾼 Pod 는 Service 에서도 빠집니다. 문제 Pod 를 서비스에서 떼어 내는 요령이 바로 이것입니다.
2. 포트 세 가지
apiVersion: v1
kind: Service
metadata:
name: guestbook
spec:
type: ClusterIP
selector:
app: guestbook # 이 라벨이 붙은 Pod 로 보냄
ports:
- port: 80 # Service 가 받는 포트
targetPort: 8000 # Pod(컨테이너)가 실제로 듣는 포트
flowchart LR
A["요청
guestbook:80"] -- "port: 80" --> S["Service"]
S -- "targetPort: 8000" --> P["Pod (gunicorn 8000)"]
N["노드 IP:30080"] -. "nodePort: 30080
(NodePort 타입일 때)" .-> S| 이름 | 누구의 포트? | 우리 예시 |
|---|---|---|
port |
Service 가 받는 포트 | 80 (그래서 http://guestbook 만 써도 됨) |
targetPort |
Pod 의 컨테이너가 듣는 포트 | 8000 (Dockerfile 의 gunicorn 포트) |
nodePort |
모든 노드에 열리는 포트 (NodePort 타입) | 30080 (범위 30000~32767) |
3주차
docker run -p 8080:8000의 "바깥 포트 : 안쪽 포트" 와 같은 개념입니다.
3. Service 타입
타입은 포함 관계입니다. 위의 타입은 아래 타입의 기능을 모두 가집니다.
flowchart TB
subgraph LB["LoadBalancer: 클라우드 로드밸런서(외부 IP)까지"]
subgraph NP["NodePort: 모든 노드의 30000~32767 포트까지"]
CIP["ClusterIP: 클러스터 안에서만 (기본값)"]
end
end| 타입 | 누가 접속할 수 있나 | 실무에서 |
|---|---|---|
| ClusterIP (기본값) | 클러스터 안의 Pod 만 | DB, 내부 API 등 대부분의 Service |
| NodePort | 노드 IP:포트로 바깥에서도 | 테스트, 직접 구축한 클러스터의 외부 LB 연결용 |
| LoadBalancer | 클라우드가 만든 외부 로드밸런서 주소로 | 관리형 K8s(EKS, AKS, GKE, NKS …)에서 외부 공개 |
Docker Desktop(kind)에서는 이렇게 동작합니다 (실제 확인)
| 타입 | 노트북에서 접속 | 비고 |
|---|---|---|
| ClusterIP | ❌ (클러스터 안에서만) | 정상 동작 |
| NodePort | ❌ localhost:30080 으로는 안 됨 |
노드가 컨테이너라서 노트북에 포트가 열리지 않음. 클러스터 안에서 노드 IP:30080 으로는 됨 |
| LoadBalancer | ✅ localhost:포트 로 됨 |
EXTERNAL-IP(172.x.x.x)가 붙지만 그 주소로는 안 되고, Docker Desktop 이 localhost 로 연결해 줌 |
예전 Docker Desktop(kubeadm 방식) 자료에는 "NodePort 를 localhost:30080 으로 접속" 이라고 나옵니다. 우리가 쓰는 kind 방식에서는 되지 않습니다.
4. 클러스터 안의 DNS: 서비스 이름이 곧 주소
클러스터 안의 DNS(CoreDNS, 6주차 kube-system 에서 본 것)가 Service 이름을 IP 로 바꿔 줍니다.
| 부르는 방법 | 언제 |
|---|---|
guestbook |
같은 Namespace 안에서 |
guestbook.default |
다른 Namespace 에서 (이름.네임스페이스) |
guestbook.default.svc.cluster.local |
전체 이름 (FQDN) |
5주차 Compose 의 "서비스 이름 = 주소" 가 클러스터 전체로 넓어진 것입니다. 9주차에 방명록이
postgres라는 Service 이름으로 DB 에 접속합니다.
5. 외부 공개의 표준: Ingress 에서 Gateway API 로
LoadBalancer 를 앱마다 만들면 앱마다 외부 IP 와 로드밸런서 비용이 생깁니다. 그래서 보통은 입구 하나를 두고, 도메인 이름이나 경로를 보고 안쪽 Service 로 나눠 보냅니다(L7 라우팅).
flowchart LR
U["사용자"] --> G["입구 하나
(Gateway)"]
G -- "guestbook.localhost" --> S1["Service: guestbook"]
G -- "hello.localhost" --> S2["Service: hello"]
G -- "그 외" --> X["404"]5-1. Ingress 와 Ingress-NGINX 의 은퇴
- 이 역할을 오랫동안 Ingress 라는 오브젝트가 맡았고, 가장 널리 쓰인 구현체가 Ingress-NGINX 였습니다.
- Ingress-NGINX 는 2026년 3월에 지원이 종료되었습니다(2025년 11월 발표). 이후로는 보안 패치도 나오지 않습니다.
- Ingress API 자체가 없어진 것은 아닙니다. 기존 시스템에서는 계속 보게 됩니다. 하지만 새로 배우고 새로 설계할 때는 Gateway API 가 권장됩니다.
5-2. Gateway API: 역할을 나눈 새 표준
Gateway API 는 Kubernetes 공식 프로젝트가 만든 Ingress 의 후속 표준입니다(우리가 쓰는 버전은 v1.6).
| 오브젝트 | 하는 일 | 주로 누가 관리 | 비유 |
|---|---|---|---|
| GatewayClass | 어떤 구현체(제품)를 쓸지 | 인프라 제공자 | 건물을 지을 시공사 |
| Gateway | 실제 입구: 어떤 포트·프로토콜로 받을지 | 클러스터 운영자 | 건물의 정문 |
| HTTPRoute | 어떤 도메인·경로를 어느 Service 로 보낼지 | 앱 개발자 | 정문 안내 데스크의 안내표 |
- 역할이 나뉘어 있어서 팀별로 권한을 나누기 좋습니다(운영팀은 Gateway, 개발팀은 HTTPRoute).
- 가중치 기반 트래픽 분배(카나리 배포, 10주차), 헤더 조건 등이 표준 기능으로 들어 있습니다. Ingress 는 제품별 애너테이션에 의존했습니다.
5-3. 구현체: 우리는 Envoy Gateway
Gateway API 는 규격이고, 실제로 트래픽을 처리하는 구현체를 설치해야 합니다.
| 구현체 | 비고 |
|---|---|
| Envoy Gateway ← 우리가 쓸 것 | Envoy 프록시 기반, CNCF 프로젝트, 설치 파일 하나로 설치 (v1.9) |
| NGINX Gateway Fabric | NGINX 기반 |
| Traefik, Istio, Cilium, Kong 등 | 각자 Gateway API 지원 |
| 클라우드 구현체 | AWS Load Balancer Controller, GKE Gateway 등 → 클라우드 로드밸런서와 연동 |
HTTPRoute 같은 우리가 쓰는 YAML 은 구현체가 달라도 같습니다. 표준의 장점입니다.
5-4. *.localhost 주소
실습에서는 guestbook.localhost, hello.localhost 를 씁니다. .localhost 로 끝나는 이름은 내 컴퓨터(127.0.0.1) 를 가리키도록 약속되어 있어서, 도메인을 사지 않고도 도메인 라우팅을 연습할 수 있습니다.
실제로 확인해 보니 Chrome·Edge·curl 은 *.localhost 를 알아서 처리했지만, Windows PowerShell 의 Invoke-WebRequest 는 The remote name could not be resolved 로 실패했습니다. 실습은 브라우저 또는 curl(Windows 는 curl.exe) 로 합니다.
핵심 요약
8주차 핵심
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
① Service Pod 묶음 앞의 고정 주소 + 로드밸런서 (selector 의 라벨로 Pod 를 찾음)
② 포트 port(Service) → targetPort(Pod) / nodePort(노드, 30000~32767)
③ 타입 ClusterIP(안에서만, 기본) ⊂ NodePort(노드 포트) ⊂ LoadBalancer(외부 LB)
Docker Desktop kind: LoadBalancer → localhost:포트 로 접속
④ DNS 같은 NS: guestbook / 전체: guestbook.default.svc.cluster.local
⑤ 외부 공개 Ingress-NGINX 는 2026년 3월 지원 종료 → Gateway API 가 후속 표준
⑥ Gateway API GatewayClass(시공사) → Gateway(정문) → HTTPRoute(안내표: 도메인·경로 → Service)
구현체: Envoy Gateway (YAML 은 구현체가 달라도 같음)
참고 자료
더 깊이 보고 싶다면 (볼트 내 정리 노트):
- 쿠버네티스 개요5: Service 타입, port / targetPort / nodePort (Ingress 부분은 은퇴 전 기준)
- Service, NodePort 서비스 생성: 개념 노트
공식 문서:
- Service: https://kubernetes.io/docs/concepts/services-networking/service/
- Gateway API: https://gateway-api.sigs.k8s.io/
- Ingress-NGINX 은퇴 공지: https://kubernetes.io/blog/2025/11/11/ingress-nginx-retirement/
- Envoy Gateway: https://gateway.envoyproxy.io/